package com.xqb.modules.service;

import com.xqb.modules.domain.dto.LearningRecordFormDTO;
import com.xqb.modules.domain.po.StdLearningRecord;

import java.util.List;

/**
 * 学习记录Service接口
 * 
 * @author xqb
 * @date 2024-10-14
 */
public interface IStdLearningRecordService 
{
    /**
     * 查询学习记录
     * 
     * @param id 学习记录主键
     * @return 学习记录
     */
    public StdLearningRecord selectStdLearningRecordById(Long id);

    /**
     * 查询学习记录列表
     * 
     * @param stdLearningRecord 学习记录
     * @return 学习记录集合
     */
    public List<StdLearningRecord> selectStdLearningRecordList(StdLearningRecord stdLearningRecord);

    /**
     * 新增学习记录
     * 
     * @param stdLearningRecord 学习记录
     * @return 结果
     */
    public int insertStdLearningRecord(StdLearningRecord stdLearningRecord);

    /**
     * 修改学习记录
     * 
     * @param stdLearningRecord 学习记录
     * @return 结果
     */
    public int updateStdLearningRecord(StdLearningRecord stdLearningRecord);

    /**
     * 批量删除学习记录
     * 
     * @param ids 需要删除的学习记录主键集合
     * @return 结果
     */
    public int deleteStdLearningRecordByIds(Long[] ids);

    /**
     * 删除学习记录信息
     *
     * @param id 学习记录主键
     * @return 结果
     */
    public int deleteStdLearningRecordById(Long id);

    /**
     * 获取学习记录列表，并按时间降序排列
     *
     * @param userId   用户ID
     * @param lessonId 课表id
     * @return 学习记录列表
     */
    public List<StdLearningRecord> selectStdLearningRecordOrderByTimeDesc(Long userId, Long lessonId);

    /**
     * 添加学习记录
     *
     * @param formDTO 学习记录表单数据传输对象
     */
    void addLearningRecord(LearningRecordFormDTO formDTO);
}
